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Preface 



As a person who is passionate in academic transmission of knowledge I found it 
really important to have a repository where scholarly publications could be archived 
and easily retrieved. My Institution / University does not have any such archiving 
facilities. I sought the advice of my teacher (who else other than google) which gave 
me some options of softwares which could be installed in a website. After a thorough 
research I found Eprint software fitted the billing to the core. On top of it it came 
free as it was open source. As with all open source software this software too lacked 
documentation. None of the manuals I saw in the internet was complete. Even the 
ones I had access to assumed that I had a basic fundamental knowledge of server 
managment. I had to struggle for nearly 3 months before I hit "Eureka ". 

Now I have embarked on creating an installation manual for the software which does 
not assume that the reader has basic knowledge of server management. The codes 
and illustrations in this book were taken from my own installation. I could have 
fallen here and there while taking my baby steps towards completing this project. I 
hope readers would appreciate this and forgive me for any errors if any in this 
manuscript. 



Please mail in your comments and suggestions to: drtbalu(d),gmail. com 



■v.w— IWI 



Eprints from below upwards by drtbalu is licensed under aCreative Commons 
Attribution-NonCommercial-NoDerivs 3.0 Unported License. 
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Introduction 



In this digital era it is imperative to safegaurd and showcase our documents / creations. Gradually 
world is moving towards the inevitable paperless domain. This is where reliable archiving facilities 
become rather important. Towards this ultimate end a large number of software have been created. 

Ideal archiving software should: 

1 . Archive the submitted material with ease 

2. Should have a robust database for storing data 

3. Should expose the digital content to search engines 

4. Should be easy to install and maintain 

5. Should be secure 

6. It should be compliant with open archives initiative protocol for metadata harvesting 

7. Last but not the least it should be cost effective 



One software that fulfills all the above said criteria withe ease is Eprints '. This is indeed a free and 
open source software which can be used to build open access repositories. Eprints has many 
features commonly seen in popular document management systems. This software is ideal for 
creating Institutional repositories 2 and scientific journals. 

This software was created by University of Southampton school of Electronics and Computer 
science in 2000. This was indeed a logical fall out of Santa Fe Meeting 3 which launched the open 
archives Initiative protocol (OAI). 

Eprints software is actually a web based command line application based on LAMP 4 architecture. 
The configuration files of EPRINTS are written in Perl / XML and hence can successfully run under 
multiple operating systems like Linux, Windows, Mac, and Solaris. It is hence easy to edit the 
configuration files according to one's requirement. 

Major problem which the author noticed with Eprints is that its literature is not adequate for a 
novice to install and maintain a repository. For any software to become popular it should be easy to 
install and operate. Eprints actually an enigma, because of inadequate literature and forum support. 
This has prompted the author to write this manuscript with an intention of taking this unique 
software to the doorsteps of even novice users. 

Is it really difficult to install and maintain an Eprint repository? 

The answer to this question is a frank no. It is only the paucity of literature that makes the task 
daunting. In this manuscript the reader will be taken in a step by step fashion through the 
installation protocol of Eprints in Ubuntu 12 server. Ubuntu 12 has been choosen not as personal 
preference but because of the convenience it provides since preconfigured Eprint installation scripts 
are available for ubuntu which takes care of dependency problems. For a novice dependency 
problems could be hair raising. 
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The aim of the book is not creating a technical manual of Eprints, but to make installation and 
maintenance of Eprint site a bit easier for novice. 

Suggested tools to be used in Eprint installation: 

1 . A virtual Private server 5 with full root access. This is the most important requisite for eprint 
installation. After complete installation eprint server takes over the entire server. (You cannot 
install eprints in shared hosting). Technically speaking it is possible to install eprints inside a folder 
of a server leaving the server free for other installations. It is an arduous task which needs lot of 
specialization and is left for those Geeks out there. 

2. Linux installation - Since this manuscript has been created with Ubuntu 12 experience, it would 
be prudent if the virtual private server (now on it will be termed as vps) is loaded with this 
operating system. 

3. A working LAMP installation in the VPS (Virtual private server). 

4. Installation of Webmin 6 which is a open source version of Cpanel. This really makes server 
configuration easy for a novice because of its GUI . 

5. Working Internet connection (This is important). 

6. SSH client ( Putty ) SSH is an acronym for secure shell 7 . This is used for accessing the virtual 
server operating system remotely from a desktop. This is usually performed using command line. 
PUTTY can be downloaded and installed in windows / Linux machines. It is a free software. 

A small word on installing PUTTY to your desktop: 

If your desktop operating system is windows then windows version of PUTTY can be downloaded 
and installed by double clicking the installer. If the desktop contains Ubuntu 12 operating system 
then PUTTY can be installed by using the command given below: 

Installing PUTTY in Ubuntu 12 desktop: 

Press ctrl-ALT-T 

This will invoke the terminal. 



sudo apt-get install putty 
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Terminal 

File Edit View Search Terminal Help 



sudo apt-get install putty 



[sudo] password for lhaveapc: 

Reading package lists... Done 

Building dependency tree 

Reading state information... Done 

The following extra packages will be installed: 

putty-tools 
Suggested packages: 

putty-doc 
The following NEW packages wilJl^be installed: 

putty putty-tools 
upgraded, 2 newly installed, to remove and 6 not upgraded. 
Need to get 1,023 kB of archives. 

After this operation, 2,258 kB of additional disk space will be used, 
Do you want to continue [Y/n]? y| 
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Virtual Private Server 



Virtual private servers can be secured from Hosting Providers like: 

Godaddy 

Siteground 

Hosting providers usually provide VPS access on monthly / yearly tariff. 

Amazon E2 Instance: 

This is another way of securing a VPS. 

A quick foray to their websites will provide relevant information. 

Before booking a VPS one has to choose a domain name to go with it. Domain name can be 
booked with any of the Hosting providers with whom VPS is going to be hosted. While booking a 
VPS one need to give the domain name also. 

Ideal VPS configuration: 

Ubuntu Linux 12 

CPU 1.68 GHZ 

Disk space 50-60 GB 

IP address - minimum of one 

Configuring VPS: 

Before configuring the VPS one should choose ubuntu 12 as the operating system. It has to be 
specified while making the purchase. 

After the VPS is set up the following details will be sent. 

1 . Url for VPS control panel 
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2. IP number assigned to the VPS 

3. Root password for the virtual machine 



Using SSH client PUTTY to configure VPS 



SSH client is the easy and secure way to log into your VPS. 
PUTTY is started: 



PuTTY Configuration 



Category: 
¥ Session 

Logging 
T Terminal 

Keyboard 

Bell 

Features 
w Window 

Appearance 

Behaviour 

Translation 

Selection 

Colours 

Fonts 
w Connection 

Data 

Proxy 

Telnet 

Rio gin 
► SSH 



About 



Basic options For your PuTTY session 
Specify the destination you want to connect to 
Host Name (or IP address) Port 



ip goesherel 



22 



Connection type: 

O Raw O Telnet O Rio gin & 

Load, save or delete a stored session 
Saved Sessions 



SSH O Serial 



Default Settings 



Load 



Save 



Delete 



Close window on exit: 
9 Always O Never 



O Only on clean exit 



Cancel 



In the hostname column the IP alloted to the VPS is entered. 
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Enter 22 under Port. 



Click Open. 




In the log in screen of PUTTY enter root after login as: 
Press ENTER key. 
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In the next screen the root password will have to be entered. 
Press ENTER again 



It will take you into the operating system. 

Caution: 

It should be noted that by default wot user is disabled in Ubuntu. If your service provider has 
enabled it root log in can be performed. 

If root user has been disabled in the VPS then the steps given below will have to be followed 
inorder to enable it. Because root user has to be enabled before Eprint installation could progress. 



Using SSH client PUTTY log into the VPS with the user name / pw supplied by the service 
provider. Key in the commands given inthe command prompt window. 



$ sudo passwd root 

[sudo] password "user name": 

Enter new UNIX password: 

Retype new UNIX password: 

passwd: password updated successfully 



The above command would effectively enable root user with associated password preferred by you. 
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urapn tnis 

Get cloud support with Ubuntu Advantage Cloud Guest; 
http ; //www , ubuntu , com/bus i ness/serv i ces/c 1 oud 

Use Juju to deploy your cloud instances and workload; 
https ; //j uj u , ubuntu , com/#c 1 oud-prec i se 



packages can be updated, 
updates are security updates. 



The programs included with the Ubuntu system are free software; 
the exact distribution terms for each program are described in the 
individual files in /usr/share/i' 

Ubuntu comes with ABSOLUTELY NO WARRANTY, to the extent permitted by 
applicable law. 

To run a command as administrator (user "root"), use "sudo <command>" 
See "man sudo_root" for details. 



ubuntuQipi 
Enter new 



h"$ sudo passwd root 



Screen shot 1 showing sudo passwd root command 



Get cloud support with Ubuntu Advantage Clout 
http; //www, ubuntu, com/business/services/cloud 



Use Juju to deploy your cloud instances and workloads; 
h ttps ; // j u j u , ubuntu , com/#c 1 oud-pr ec i se 

packages can be updated, 
updates are security updates. 



The programs included with the Ubuntu system are free software; 
the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/Vcopyright, 

Ubuntu comes with ABSOLUTELY NO WARRANTY, to the extent permitted by 
applicable law. 



To run a command as administrator (user "re 
See "man sudo_root" for details, 

ubuntulHip-ftB^HRM! '$ sudo passwd root 
Enter new UNIX password: 
Retype new UNIX password; I 



), use "sudo -(command) 



Screen shot 2 showing password change for root log in effected. Password needs to 

be typed twice in this screen before pressing enter key. Caution: Typed password will 

not be revealed on the screen. The screen will look empty as you key in the pass 

word. 



Otolaryngology online 



http : //www .ubuntu. com/bus iness/serv ices/cloud 



Use Juju to deploy your cloud instances and workloads; 
https ; // j u j u . ubuntu . com/#c 1 oud-prec i se 

packages can be updated, 
updates are security updates. 



I"he programs included with the Ubuntu system are free software; 
the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/*/copyright. 

Jbuntu comes with ABSOLUTELY NO WARRANTY, to the extent permitted by 
applicable law. 

l"o run a command as administrator (user "root"), use "sudo <command>" 
5ee "man sudo_root" for details. 

ibuntu@ip-4l P;"$ sudo passwd root 

inter new UNIX password; 

ietype new UNIX password; 

>asswd; passwordupdated successfully 

ibuntuS i n-Btim^^ ♦ "t. 



Screen shot 3 showing confirmation of pass word update 



Installation of Apache Web Server 



Apache is a free open source server software. It needs to be installed. Before 
proceeding with Apache installation the Ubuntu operating system needs to be 
updated. 



Using the terminal window of SSH client Putty key in the following command: 



sudo apt-get update 
sudo apt-get install apache2 



ubuntuQip-^ 

No command 'root' found, did you mean; 
Command Vootv' from package 'xawtv' (universe) 
Command Vott' from package Vott' (multi verse) 
Command 'rbot' from package 'rbot' (universe) 

root; command not found 

ubuntu@ip-10-203-78-ll:~$ sudo root 

sudo: root: comman d not found 

ubuntuQip-j^ 

roots iD-^fa«oi*iiio^B*/home/ubuntu# sudo apt-qet update 



Screen shot showing sudo apt-get update 



lit http://us-east-l.ec2, archive, ut 

lit http;//security, ubuntu, com precise-secu 

lit http://us-east-l.ec2, archive, ubuntu.com 

Set : 13 http://us-east-l.ec2. archive. ubuntu, 

as [G34 kB] 

Ut http://us-east-l.ec2.archive.ubuntu.com 



rity/universe Translation-en 
precise-updates/universe Sources 
com precise-updates/main amdG4 Packai 

precise-updates/universe amdG4 Pack 



Jit http://us-east-l.ec2.archive.ubuntu.com 

Set : 14 http://us-east-l.ec2. archive. ubuntu. 

;ages [209 kB] 

iet;15 http://us-east-l.ec2, archive, ubuntu, 

idex [3,5G4 B] 

jet;16 http : //us-east-1 , ec2 , archive, ubuntu , 

.onlndex [2,850 E] 

Set : 17 http : //us-east-1 , ec2 , archive, ubuntu , 

iB] 

U t http ; //us-east-1 , ec2 , archive, ubuntu , com 

Set : 18 http : //us-east-1 , ec2 , archive, ubuntu , 

;n [290 kB] 

U t http ; //us-east-1 , ec2 , archive, ubuntu , com 



precise-updates/main i38G Packages 
com precise-updates/universe i38G Pa 

com precise-updates/main Translation! 

com precise-updates/universe Translat 

com precise/main Translation-en [72G 

precise/universe Translation-en 
com precise-updates/main Translation- 
precise-updates/universe Trans 1 at i or 



r etched 4,042 kB in 2s (1,702 kB/s) 
heading packag e list s.,. Done 

!;/home/ubuntu# 



Screen shot after update process is completed 
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PI dont forget to press enter after each line of command. 

After Apache installation is completed successfully it needs to be tested. This can be done by 
keying in the IP number associated with the VPS to the address bar of the browser. You should see 
the page saying "It Works". If this page is displayed then it indicates that apache server has been 
installed and is running fine. 



> * e • 16 



!o: http://127.0.0.1/ 



|«T|coog:e €t| 



jig Most Visited » IclGetting Started l_l Latest Headlines* -*1 tedious inhindi-Goo... £j Google Translate -*f Google URL Shortener 
| © http://127.0.0.1/ ~~| Q 

It works! 

This is the default web page for this server. 

The web server software is running but no content has been added, yet. 



H o ^p*sg * 



Screenshot of the page indicating successful installation of apache server 
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If on keying the IP number associated with the VPS to the address bar of browser the default page 
"It works" is not displayed / page not found error is displayed then key in the following command 
to the command terminal of SSH PUTTY client. 



sudo service apache! restart 

This command prompt effectively restarts the apache server. 



Installing MySQL 



My SQL 8 is a powerful database software. This is used to manage database, organizes and retrieves 
data from the database. This popular Relational Database System runs as a server providing 
multiuser access to a number of databases. My SQL actually does not have a GUI and needs to be 
manipulated using command line tools. For installing Eprints not much knowlege of of structured 
query language is needed as the software is capable of configuring SQL server automatically. 



To Install MySQL open the terminal window using ssh client PUTTY after logging in as root you 
can type the following command: 



sudo apt-get install mysql-server Ubapache2-mod-auth-mysql php5-mysql 
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* Documentation: https: //he lp.ubuntu.com/ 

System information as of Tue Jun 11 15:52:17 UTC 2013 

System load; 0,0 Processes: 61 

Usage of /: 12+32 of 7+87GE Users logged in: 

Memory usage: All IP address for ethO: 10.203.78.11 

Swap usage: 0% 



this data and manage this system at https://landscape.canonical.com/ 



Get cloud support with Ubuntu Advantage Cloud Gl 
http://www.ubuntu.com/business/services/cloud 



Use Juju to deploy your cloud instances and workloads; 
ht tps ; // j u j u , ubuntu , com/#c 1 oud-pr ec i se 

ast loginMueJunU 11:49:05 2013 from 1 
buntulji p-^ ^^^.;"$ sudo su 
ootGip-^^^jHBk/home/ubuntutt sudo apt-get install mysql-server libapache£ 
mysql | 



Screen shot showing the command keyed in to install mysql server 



_ _1 1;49:05 2013 from 

ibuntu@ip J ^PWB*s*^^'$ sudo su 

~~Tp;/home/ubuntu# sudo apt- 
iod-auth-mysql php5-mysql 
ieading package lists... Done 



BliraiHH 



!eading state information... Done 

he following extra packages will be installed; 
libdbd-mysql-perl libdbi-perl libhtml-template-perl libmysqlclientlS 
libnet-daemon-perl libplrpc-perl libterm-readkey-perl mysql-client-5.5 
mysql-client-core-5.5 mysql-common mysql-server-5.5 mysql-server-core-5.5 
php5-common php5-fpm 

Suggested packages; 
libipc-sharedcache-perl tinyca mailx php5-suhosin php-pear 

he following NEIil packages will be installed: 
libapache2-mod-auth-mysql libdbd-mysql-perl libdbi-perl 
libhtml-template-perl libmysqlclientlS libnet-daemon-perl libplrpc-perl 
libterm-readkey-perl mysql-client-5.5 mysql-client-core-5.5 mysql-common 
mysql-server mysql-server-5.5 mysql-server-core-5.5 php5-common php5-fpm 
php5-mysql 

) upgraded, 17 newly installed, to remove and 40 not upgraded. 

Jeed to get 30.9 ME of archives. 

}fter this operation, 107 MB of additional disk space will be used. 



Screen shot showing confirmation query after keying in the command to install mysql server 
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aaaaaaaaaaaaaaaaaaaaaaH Configuring mysql-server-S.S aaaaaaaaaaaaaaaaaaaaaaal 
Tile not mandatory, it is highly recommended that you set a password a 



a for the MySQL administrative "root" user, 

3 

a If this field is left blank, the password will not be changed, 

a 

a New password for the MySQL "root" user: 



a 
a 
a 
a 



<0k> 



=taaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 




After installation mysql configuration screen asks for root password setting. You need to choose a 

password key it in. Press tab the ok button will be highlighted. On pressing the enter key the next 

confirmation password screen will be displayed asking for password retype. 



During installation MySQL will ask you to set a root password. Give a root password of your 
choice. If you have missed this step, it can also be easily done through MySQL shell. By default 
MySQL does not have a root password. 



MySQL now needs to be activated. You need to key in the following command in the command 
prompt window to activate it: 



sudo mysql _install_db 



The next step one need to take is to secure the MySQL database server installation. 
This can be done by keying in the following script in the command prompt window. 



sudo /usr /bin/my sql_secure_installation 



treating config file /etc/php5/fpm/php.ini with new version 

letting up libapache2-mod-auth-mysql (4.3.9-13ubuntu3) . .. 

letting up libhtml -temp late-perl (2.10-1) ... 

Setting up mysql-server (5.5.31-0ubuntu0.12.04.2) ... 

Setting up php5-mysql (5.3.10-lubuntu3.6) ... 

Processing triggers for libc-bin ... 

Ldconfig deferred pr ocessing now taking place 

"oot@ip-^H«i>i«ii^Pi:/home/ubuntu# sudo /usr/bin/mysql_secure_ install at ion 



CTE: RUNNING ALL PARTS OF THIS SCRIPT IS RECOMMENDED FOR ALL MySQL 
SERVERS IN PRODUCTION USE! PLEASE READ EACH STEP CAREFULLY! 



In order to log into MySQL to secure it, we'll need the current 
password for the root user. If you've just installed MySQL, and 
jou haven't set the root password yet, the password will be blank 
so you should just press enter here. 



inter current passwo 



root (enter 



none): | 
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Screen shot showing the prompt asking for a change of root password 



The command prompt will now ask for the root password you had keyed in the previous window, 
you had not keyed in any password then all you need to do is to press the enter key, of if you had 
choosen a root password then key it in and press the enter key 



If 



http : //www .ubuntu. com/bus iness/serv ices/cloud 



Use Juju to deploy your cloud instances and workloads; 
https ; // j u j u . ubuntu . com/#c 1 oud-prec i se 

packages can be updated, 
updates are security updates. 



I"he programs included with the Ubuntu system are free software; 
the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/*/copyright. 

Jbuntu comes with ABSOLUTELY NO WARRANTY, to the extent permitted by 
applicable law. 

l"o run a command as administrator (user "root"), use "sudo <command>" 
lee "man sudo_root" for details. 



ibuntu@ip- 
inter new 
ietype nr- 
>asswd: 
ibuntu@i 



t"$ sudo passwd root 

-assword; 

■ed successfully 



Password change confirmation screen 



The next prompt will ask whether you need to set / change the root password. If you want to 
change it you need to key in the new password and press the enter key. You need to do it twice for 
confirmation. 

It should be borne in mind the default MySQL server installation has an anoymous user enabled. 
So one can log into MySQL database as a anoymous user. This access has been provided in order 
to conduct tests to find out whether MySQL server has been installed. In production environment 
anoymous user to the database need to be disabled. The previous step is intended to secure this 
installation. 

When the command prompt asks: 

Remove anonymous users? [Y/n] - You need to give yes by keying in "Y" and pressing the enter 
key. 
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In order to log into MySQL to secure it, we'll neei 
password for the root user. If you've just installed MySQL, and 
you haven't set the root password yet, the password will be blank, 
so you should just press enter here. 

Enter current password for root (enter for none): 
OK, successfully used password, moving on,,. 

Setting the root password ensures that nobody can log into the MySQL 
root user without the proper authorisation. 

You already have a root password set, so you can safely answer 'n'. 

Change the root password? [Y/n] n 
,,, skipping. 

By default, a MySQL installation has an anonymous user, allowing anyone 
to log into MySQL without having to have a user account created for 
then. This is intended only for testing, and to make the installation 
go a bit smoother. You should remove them before moving into a 
production environment. 

Remove anonymous users? [Y/n] 



Screen shot showing command prompt asking whether anonymous users can be removed. The 

answer should obviously be yes. 



For security purposes normally root should be able to connect to the database only from the "Local 
Host". This can be ensured by giving the following command for the next prompt which is likely to 
come into your command prompt window: 

Disallow root login remotely? [Y/n]: You need to press "Y" and press enter key following it. 
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etting the root password ensures that nobody can log into the MySQL 
*oot user without the proper authorisation. 



'ou already have a root password set, so you can safely answer 'n'. 

Change the root password? [Y/n] n 
... skipping. 



Sy default, a MySQL installation has an anonymous user, allowing anyone 
;o log into MySQL without having to have a user account created for 
;hem. This is intended only for testing, and to make the installation 
o a bit smoother. You should remove them before moving into a 
production environment. 

iemove anonymous users? [Y/n] yes 



.ormally, root should only be allowed to connect from 'localhost'. This 
insures that someone cannot guess at the root password from the network, 

lisallow root login remotely? [Y/n] I 



By default MySQL database server comes with a Test database already installed. This is meant for 
testing purposes only. It should be removed when moving to a production environment. 

In the next command prompt: 

Remove test database and access to it? [Y/n]: You need to press "Y" and press enter key later. 
This removes test database. 



isallow root login remotely? [Y/n] yes 
. . . Success I 



R!933uTirai!l 



j default, MySQL comes with a database named 'test' that anyone can 
;cess. This is also intended only for testing, and shoul 
sfore moving into a production environment. 

;move test database and access to it? [Y/n] yes 

- Dropping test database... 
... Success! 

- Removing privileges on test database... 
... Success! 

^loading the privilege tables will ensure that all changes mat' 
ill take effect immediately. 

;load privilege tables now? [Y/n] 



The next prompt asks: 

Reload privilege tables now? [Y/n]: You need to key in "Y" and press enter key later. 

After cleaning up the MySQL installation has completed. 
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It is time now to start your MySQL server. Key in the command given below in the command 
prompt window: 



sudo service mysql start 



This will start MySQL server. 



start: Job is already running: mysql 
i/home/ubuntu# I 



Installation of PHP 
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Actually speaking this step is not necessary for the functioning ofeprints. This is being done to 
facilitate installation ofPhpmyadmin which is a convenient GUI for manipulation ofsql data if 
need arises. 

PHP also known as (Hypertext preprocessor) is an open source web scripting language used to 
create dynamic web pages. It is a server side scripting language installed in a server. This scripting 
language was originally created by Rasmus Lerdof in 1995 9 . This scripting language is operating 
system independent and can be installed as part of any server or as a stand alone application too. 

In order to install PHP to ubuntu server log into the virtual machine using SSH client (PUTTY) as 
root. In the ensing terminal key in the command given below: 



sudo apt-get install php 5 Ubapache2-mod-php5 php5-mcrypt 



You may need to answer "yes" twice in the command prompt. PHP will install itself. 



/home/ubuntu# sudo apt-get install php5 libapache2-mod-php 
php5-mcrypt 
Reading package lists,.,,. Done 
Building dependency tree 
Reading state information,,. Done 
The following extra packages will be installed; 

apache2-mpm-prefork libmcrypt4 php5-cli 
Suggested packages; 

php-pear libmcrypt-dev mcrypt 
The following packages will be REMOVED; 

apache2-mpnrworker 
fhe following NEW packages will be installed; 

apache2-mpm-prefork libapache2-mod-php5 libmcrypt4 php5 php5-cli php5-mcrypt 
upgraded, 6 newly installed, 1 to remove and 40 not upgraded. 
Need to get 6,296 kB of archives, 

After this operation, 17,3 MB of additional disk space will be used. 
Do you want to continue [Y/n]? I 



Screen shot asking for confirmation to install php 
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Unpacking libmcrypt4 (from , ♦♦/libmcrypt4_2,5.,S-3. 1 l_amd64,deb) ♦ ,, 

Selecting previously unselected package php5. 

Unpacking php5 (from ,.,,/php5_5,3,10-lubuntu3. 1 6_all,deb) , „ 

Selecting previously unselected package php5-cli. 

Unpacking php5-cli (from ,.,,/php5-cli_5,3 t 10-lubuntu3,S_amdS4,deb) ,.,, 

Selecting previously unselected package phpEJ-mcrypt, 

Unpacking php5-mcrypt (from ♦ ♦,/php5-mcrypt_5.,3,5-0ubuntul_amd64,deb) 

Processing triggers for man-db , ,♦ 

Setting up libapache2-mod-php5 (5,3,10-lubuntu3,6) ... 

Creating config file /etc/php5/apache2/php,.ini with new version 

* Restarting web server apache2 

,,♦ waiting 
Setting up libmcrypt4 (2*5, 8-3,1) ,,, 
Setting up php5 (5,3.,10-lubuntu3,6) ... 
Setting up php5-cli (5,3.,10-lubuntu3,6) , „ 



Creating config file /etc/php5/cli/php,ini with new version 
update-alternatives; using /usr/bin/php5 to provide /usr/bin/php (php) in auto 
ode* 

Setting up phpEJ-mcrypt (5,.3,5-Oubuntul) , „ 
Processing triggers for libc-bin ... 
ldconfiq deferred processing now taking place 
;/home/ubuntutt I 
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Command prompt window as seen after completion of php installation 



Now you need to restart apache to complete the settings change. This can be done by keying the 
command given below. 



sudo service apache2 restart 



You may want to add useful PHP modules and libraries to your virtual machine. This can be done 
using the same command prompt window. For a beginner I would advice these module / libraries 
installation be deferred till Webmin is installed. It would provide a nice GUI for manipulating these 
modules and libraries. The curious can attempt command prompt installation method given below. 
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To see the possible libraries / modules available key in the command given below in the command 
prompt window: 



apt-cache search php5- 



-intl - inter nationalisation nodule for php5 

-lasso - Library for Liberty Alliance and SAML protocols - PHP 5 bindings 

-librdf - PHP5 language bindings for the Red land RDF library 

-mapscript - php5-cgi module for MapServer 

-ncrypt - MCrypt nodule for php5 

-nencache - nemcache extension nodule for PHP 

-nencached - nencached extension nodule for PHP5, uses libmencached 

-nidgard2 - Midgard2 Content Repository - PHP5 language bindings and nodule 

-ning - Ming nodule for php5 

-nysqlnd - MySQL nodule for php5 (Native Driver) 

-ps - ps nodule for PHP 5 

-radius - PECL radius module for PHP 5 

-renctl - PECL nodule for Kerberos-authenticated connand execution 

-rrd - rrd nodule for PHP 5 

-sasl - Cyrus SASL extension for PHP 5 

-suhosin - advanced protection nodule for php5 

-svn - PHP Bindings for the Subversion Revision control systen 

-Sybase - Sybase / MS SQL Server nodule for php5 

-tokyo-tyrant - PHP interface to Tokyo Cabinet's network interface, Tokyo T; 

-uuid - OSSP uuid module for php5 
-xcache - Fast, stable PHP opcode cacher 
-xdebug - Xdebug Module for PHP 5 
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The terminal will display the possible libraries that can be installed. The list could be like this: 



php5-cgi - server-side, HTML-embedded scripting language (CGI binary) 

php5-cli - command-line interpreter for the php5 scripting language 

php5-common - Common files for packages built from the php5 source 

php5-curl - CURL module for php5 

php5-dbg - Debug symbols for PHP5 

php5-dev - Files for PHP5 module development 

php5-gd - GD module for php5 

php5-gmp - GMP module for php5 

php5-ldap - LDAP module for php5 

php5-mysql - MySQL module for php5 

php5-odbc - ODBC module for php5 

php5-pgsql - PostgreSQL module for php5 

php5-pspell - pspell module for php5 

php5-recode - recode module for php5 

php5-snmp - SNMP module for php5 

php5-sqlite - SQLite module for php5 

php5-tidy - tidy module for php5 

php5-xmlrpc - XML-RPC module for php5 

php5-xsl - XSL module for php5 

php5-adodb - Extension optimising the ADOdb database abstraction library 

php5-auth-pam - A PHP5 extension for PAM authentication 



After deciding on the modules to be installed the they can be installed individually by keying in the 
following command in the command prompt window: 



sudo apt-get install name of the module 



Otolaryngology online 



These modules can also be installed after installing webmin via its GUI interface. This method is 
easy for a beginner. 



PHPMyAdmin " Installation 



This script written in PHP provides a good GUI interface for managing SQL tables and data. Entire 
database of Mysql can be managed using this web interface. This takes away the pain of keying in 
commands in the command prompt window. 



sudo apt-get install phpmyadmin 



http ; //www * ubuntu * com/bus i ness/ser v i ces/c 1 oud 

Use Juju to deploy your cloud instances and work 
https://juju* ubuntu *com/#c loud-precise 



sst login*TueJuri 

■M ^^K:"$ sudo su 
)ot@ip-4^HMfl^^:/homeAjbuntu# sudo apt-get install phpmyadmin 
sading package lists*** Done 
jilding dependency tree 
ading state information*** Done 
ie following extra packages will be installed: 

dbconf ig-common fontconf ig-conf ig libfontconf igl libgd2-xpm libjpeg-turboS 
libjpegS libtl-5 libxpm4 php5-gd ttf-dejavu-core 
iggested packages: 
libgd-tools 

ie following NEW packages will be installed: 

dbconf ig-common f ontconf ig-conf ig libfontconf igl libgd2-xpm libjpeg-turboS 
libjpegS libtl-5 libxpm4 php5-gd phpmyadmin ttf-dejavu-core 
upgraded, 11 newly installed, to remove and 40 not upgraded* 
:ed to get 8,070 kB of archives* 

■ter this operation, 22*6 ME of additional disk space will be used* 
) you want to continue [Y/n]? I 
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Screen shot showing command prompt seeking permission before installation of PHPMyadmin 



During installation the PHPMyadmin installer will walk you through the various configuration 
parameters. 

As a first step you need to select the server. In this case select Apache which will be the first one in 
the list. Selection can be made by pressing the space bar. Press the tab key till the OK button gets 
red and then press enter key for the settings to take effect. 



Package configuration 



j Configuring phpmyadmin | 

Please choose the web server that should be automatically configured to 
run phpMyAdnin, 

Web server to reconfigure automatically: 



[ ] apache2 
I liqhttpd 



<Ok; 



The next question the installer will pose is whether you want to configure the 
database for PHPMyadmin with db-config common. The answer should be yes. 
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1 Configuring phpmyadmin | 

The phpmyadmin package must have a database installed and configured 
before it can be used. This can be optionally handled with 
dbconfig-common. 

If you are an advanced database administrator and know that you want to 
perform this configuration manually, or if your database has already 
been installed and configured, you should refuse this option. Details 
on what needs to be done should most likely be provided in 
/usr/share/doc/phpmyadmin. 

Otherwise, you should probably choose this option. 

Configure database for phpmyadmin with dbconfig- common? 



<No> 



In the next screen the installer will ask if you want to reset / change the mysql root password. If 
you had not set the root password during installation of mysql server now is the time to do it. 

Otherwise you can safely skip this step. 




After installation is complete phpmyadmin should be added to apache configuration file. This can 
be done using command line editor or the step can be deferred till you complete installation of 
webmin when you will have a comfortable GUI and text editor to do the job. 
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su do nano /etc/apache2/apache2.conf 



This command prompt will evoke nano editor in the command prompt window and you need to add 
the line given below to the apache2.conf. File displayed on your screen. 



Include /etc/phpmy admin/apache, conf 



Now you need to restart apache server. 



sudo service apache2 restart 



PHPMyadmin installation can be checked by keying in the following in the address bar of your 
favorite web browser: 
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youripaddress/phpmyadmin 



phpMyAOffffn 

Welcome to phpMyAdmin 





Language 




























English T 




















Log In ft 
























UBemame: 


I 












Password: 














<S 




_Li Cookies must be enabled past this point. 





This will be the screen displayed 



You can enter the interface by giving: 



user name: root 



Password: your root password 
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phpMyAdmin 



a 



* •& (D € 



I lnformation_schema 

j mysql 

I performances c hema 

; pnpmyadm I n 



laBSI 


..j Databases 


QSQL 


_ Status 


_,J Processes 


ng Privileges 


L^ Export 


^..v Import 


£j Variables 


m Charsets 


▼ More 



General Settings 



W Change password 



ss MySQL connection collation . f : utf8_general_ci 



Appearance Settings 



I Language 



English 



Theme/ Style: pmahomme " 



Font size: a2% » 



More settings 



MySQL 



Server Localhost via UNIX socket 

Server version: 5.5.31-OubuntuO. 12.04.2 

Protocol version: 10 

User: root@localnost 

MySQL chars-et: LTTF-8 Unicode (utfS) 



Web server 



Apacne/2.2.22(UbuntLi) 
MySQL client version: 5.5.31 
PHP extension: mysqli g 



phpMyAdmin 



Version information: 3_4.10.1deb1 

Documentation 

Wiki 

Official Homepage 

Contribute 

Get support 

List of changes 
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Webmin Installation 



Webmin 10 is actually a web based open source control panel which can be used to configure and 
control the virtual private server. Configuration can be done using any of the modern browser 
interface. Java should be enabled in these browsers for using file manager module of webmin. It 
can be used to set up and configure user accounts, Apache configuration, DNS settings, file sharing 
etc. It can also be used to edit various linux configuration files. 



Before actually attempting to install webmin the various Perl files need to be installed. This can be 
done by keying in the following command as root in the command prompt window of SSH client 
PUTTY. 



sudo apt-get install perl libnet-ssleay-perl openssl libauthen-pam-perl 
libpam-runtime libio-pty-perl apt-show-versions python 



After keying in the above command continuously and pressing the enter key the perl dependencies 
of webmin gets installed. 



* root@ip-10-203-78-11: /home/ubu 



https;/ 



u , com/#c 1 oud-pr ec i se 



.ast loginJ_ 
ibuntu@ip 
>oot@ip-10-203-78-ll:/l 
ipenssl li 



1 ibpam- 



apt-get inst 
e libio- 



;rl libnet-ssleay-perl 
apt-show-versions pythi 



heading package lists,,. Done 

building dependency tree 

'eading state information,,. Done 

I ibpam-runtime is already the newest version, 

>ython is already the newest version, 

jerl is already the newest version, 

rhe following extra packages will be installed; 

libapt-pkg-perl 
rhe following NEW packages will be installed: 

apt-show- vers ions libapt-pkg-perl libauthen-pam-perl libio-pty-perl 

libnet-ssleay-perl 
fhe following packages will be upgraded; 

openssl 
L upgraded, 5 newly installed, to remove and 39 not upgraded, 
teed to get 893 kB of archives, 

Ifter this operation, 1,323 kB of additional disk space will be used. 
In unu want tn mntinue TY/nT? I 



Screen shot showing command prompt seeking permission to install perl 
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Webmin .deb package needs to be downloaded. This can be done easily by keying in the command 
given below: 



wget http://prdownloads.sourceforge.net/webadmin/webmin_l .630 _all.deb 



,630_all,deb [following] 

-2013-06-12 00:45:45— http://downloa 

i/l ,E30 Aiebui i n_l ,630_al 1 ,deb 

iesolving downloads.sourceforge.net (downloads.sourcefor9e.net),,, 216,34,181,5!" 

ieusing existing connection to prdownloads,sourceforge,net:80, 

ITTP request sent, awaiting response,,, 302 Found 

.ocation; http;//i web, dl,sourceforge, net/pro ject/webadmin/webnin/l,630/webmin_l 

!30_all,deb [following] 

—2013-06-12 00:45:46 — htt p :// i web , d 1 , sour cef or ge , net/pro j ect/webadm i n/webm i n/ 

. , 630/webm i n_l , 630_a 1 1 , deb 

iesolving iweb,dl,sourceforge,net (iweb, dl.sourceforge.net),,, 70,33,0,134, 260/ 

f 748:10:12: :5f:2 

Connecting to iweb,dl,sourceforge,net ( iweb,dl,sourceforge, net) 170,38,0,1341 ;80 

',, connected, 

ITTP request sent, awaiting response,,, 200 OK 

Length: 21101770 (20M) [application/x-debian-package] 

iaving to: *webmin_l,630_all,deb' 

.002[======================================>] 21,101,770 2.10M/S in 12s 

!013-06-12 00:45:57 (1,70 MB/s) - *webmin_l,630_all,deb' saved [21101770/211017;, 



''hone/ubuntutt 



Screenshot of command prompt displayed on completion of webmin download 
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The downloaded package can be installed using the following command: 



sudo dpkg -i webmin_l.630_all.deb 



'ootQip-^^WW^K./home/ubuntu* sudo dpkg -i webmin_l,630_all. 1 deb 

Selecting previously unselected package webmin, 

Reading database „,, 50054 files and directories currently installed, 

Jnpacking webmin (from webmin_l„630_all,deb) , ,, 

: etting up webmin (1,630) ,** 



Unpacking webmin (from webmin_l,630_all,< 

Setting up webmin (1*630) ... 

Webmin install complete* You can now login to https;//ip- 

as root with your root password, or as any user who can l 

to run commands as root* 



Screen shot showing webmin installation confirmation screen 

Webmin can be accessed by keying in the following address in your favorite browser's address bar: 

https://yourIP: 10000 

If you have a domain pointing to the virtual private server then it can be substituted for the IP 
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address. 



You need to ignore the browser warning which says that the certificate for the site cannot be trusted. 



Login to Webmin 


You must enter a usemame and password to login to tne Webmin server on 


User name 












Password 








■ Remember login permanently? 






Login 


Clear 





In the log in screen as shown above you need to key in root as the user name and the root password 
of your linux virtual private server. 
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Login: root 

Webmin 

System 

Servers 
' Others 

Networking 

Hardware 

Cluster 
ft Un-used Modules 
Search: | 

iiiView Module's Logs 
fii System Information 
(IS Refresh Modules 
©Logout. 



^ uiebmin 

System hostname 

Operating system Ubuntu Linux 12.04.2 

Webmin version 1.630 

Tlmeon system Wed J Lin 12 01:03:562013 

Kernel and CPU Linux 3.2.0-40-virtual onx36_64 

Processor Information Intel(R) Xeon(R) CPU E5430 @ 2.66GHz, 1 cores 

System uptime 1 days. hours. 28 minutes 

Running processes 75 

CPU load averages 0.00(1 min) 0.09 (5 mins)Q.10 (15 mlns|i 

CPU usage 2% user, 5% kernel, 7% IO, 66% idle 

Real memory 590.19 MB total. 179.04 MB used 



Local disk space 7.37 GB total. 1.73 GB used 



Package updates 39 package updates are available 



Module 


Version 


Running Processes 


1.632 


Running Processes 


1.631631 



The 2 following Webmin module updates are now available .. 
Fixes problem 

Fixes total and free memory display on OpenVZ systems 
Fixes incorrect memory display on OpenVZ 



Install Updates Now 



This is the webmin screen. You can install updates by clicking the install updates button now. 
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Eprint Installation 



Main advantage of installing eprints in ubuntu is there are preconfigured installation files available, 
hence one need not encounter dependency issues during installation. 

To install preconfigured eprint installation repositories need to be added to the ubuntu repo list. The 
list is present in /etc/apt/sources. list. The following lines need to be added to this list using the file 
browser feature of webmin. 

Log into webmin using root password. 

On the side bar click the others button. 



Login: root 

Webmin 
System 
Servers 
• Others 
Command Shell 

Hands 



"■aiE^jjhligifj* 



Perl Modules 
PHP Configuration 
Protected Web Directories 
SSH Login 

System and Server Status 
Text Login 

Upload and Download 
Networking 
Hardware 
Cluster 

Un-used Modules 
Search: 



&. View Module's Logs 
jft System Information 
[§ Refresh Modules 
(§) Logout 



%® 



Conf ig 



C^ 7 



o 



% 



H 



□ «t # v^ p ^Q#a 



Upload 



Copy 



Cut Paste 



E3Z 

-jj|bin 

-£)boot 

-Qdev 

-fiste 

— Q)home 

-£j)lib 

-§|lib84 

-(^|lost+found 

-Smedia 

-Smrrt 

-§opt 

-Fanrnr 

-Qroot 

-£lrun 

-Qsbin 

-^selinux 

-Qsrv 

-£3sys 

-Qtmp 

-Qusr 

H^jvar 



a 

D 
D 
■ 
D 
Q 

D 
Q 

D 
Q 
D 

■ 
D 
■ 
D 
Q 
Q 
Q 
D 
Q 
D 

J 



JA 



Mane 



bin 

boot 

dev 

etc 

home 

initrd.img 

lib 

Ub64 

lost+found 

media 

mnt 

opt 

proc 

root 

run 

sbin 

selinux 

srv 

sys 

tmp 

usr 

var 

vmlinuz 

webmin-setup,out 



Size 



User Group 



4 kB 


root 


4 kB 


root 


3 kB 


root 


4 kB 


root 


4 kB 


root 


33 B 


root 


4 kB 


root 


4 kB 


root 


18 kB 


root 


4 kB 


root 


4 kB 


root 


4 kB 


root 


G B 


root 


4 kB 


root 


4G B 


root 


4 kB 


root 


4 kB 


root 


4 kB 


root 


G B 


root 


4 kB 


root 


4 kB 


root 


4 kB 


root 


29 B 


root 


8 kB 


root 



root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 
root 



Date 



11/Apr 

11/Jun 

11/Jun 

06:44 

11/Apr 

11/Apr 

11/Apr 

11/Apr 

11/Apr 

11/Apr 

Apr/12 

11/Apr 

11/Jun 

06:34 

Q6:51 

11/Apr 

Mar/12 

11/Apr 

11/Jun 

15:47 

11/Apr 

06:25 

11/Apr 

06:26 



On clicking the file manager this view will open up provided Java is enabled in your browser. 
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## Uncomment the to L Lowing two Lines to add software trom CanonicaL's 
## 'partner' repository, 

## This software is not part of Ubuntu, but is offered by Canonical and the 
## respective vendors as a service to Ubuntu users. 

# deb http://archive.canonical.com/ubuntu precise partner 

# deb-src http : //archive , canonical , com/ubuntu precise partner 

deb http://security.ubLintLi.com/ubuntu precise-security main 
deb-src http://security.ubuntu.com/ubuntu precise-security main 
deb http: //security .LibLintLi.com/LibLintu precise-security universe 
deb-src http://security.ubuntu.com/ubuntu precise-security universe| 

# deb http://security.ubuntu.com/ubuntu precise-security multiverse 

# deb-src http : //security , ubuntu , com/ubuntu precise-security multiverse 



deb http://deb.eprints.org/ stable/ 
deb-src http://deb.epnnts.org/ source/ 



You need to add the lines given below at the end of the file for adding eprint repositories to ubuntu 
server. 



deb http : //deb . eprints . org/ stable/ 
deb-src http : //deb . eprints . org/ source 



Log into the virtual machine using SSH client like PUTTY. 

Become root user. 

Key in: 

sudo apt-get update 

This command will update repository list by including eprint data. 



Sudo apt-get install eprints 
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iet;lG http://us-east-l.ec2.archive.ubuntu.com precise-updates/universe andG4 Pi 
;kages [206 KB] 

'it http://us-east-l.ec2.archive.ubuntu.com precise-updates/main i386 Packages 
jet;17 http://us-east-l.ec2.archive.ubuntu.com precise-updates/universe i386 Pat 
;ages [209 kB] 

'ettlS http;//deb,eprints,org stable/ Packages [865 B] 

iet;18 http://us-east-l.ec2.archive.ubuntu.com precise-updates/main Translation! 
idex [3,564 B] 

*et;20 http://us-east-l.ec2.archive.ubuntu.com precise-updates/universe Translal 
onlndex [2,850 B] 

.it http://us-east-l.ec2.archive.ubuntu.com precise/main Translation-en 
-et;21 http://us-east-l.ec2.archive.ubuntu.com precise/universe Translation-en I 
,341 kB] 

,et;22 http://deb.eprints.org source/ Sources [2,737 B] 
!gn http://deb.eprints.org stable/ Trans 1 at ion-en_US 

!et;23 http://us-east-l.ec2.archive.ubuntu.com precise-updates/main Translation- 
*n [280 kB] 

.it http://us-east-l.ec2.archive.ubuntu.com precise-updates/universe Translatioi 
■en 

!gn http://deb.eprints.org stable/ Translation-en 
: etched 15.8 MB in 10s (1,515 kB/s) 
ieading package lists... Bone 

/home/ubuntutt sudo apt-get install eprintsl 



Command prompt showing installation ofeprints 



libltdl7 liblua50 liblualibSO liblwp-mediatypes-perl 
liblwp-protocol-https-perl libmagickcore4 libmagickcore4-extra 
libmagickwand4 libmail-sendmail-perl libmail tools-perl li' 
libmime-types-perl libmodule-f ind-perl libnet-http-perl libnetpbmlO 
libopenexrG libpangol.O-0 libpaper-utils libpaperl libpathplan4 libperl5,14 
libpixman-1-0 libpopplerl8 libreadline5 librsvg2-2 librubyl.8 
libsearch-xapian-perl libsepoll libsm6 libsocket6-perl 

libsys-hostname-long-perl libthai-data libthaiO libtie-ixhash-perl 1 ibtif f4 
libtre5 libunicode-string-perl libunistringO liburi-perl libwmf 0.2-7 
libwww-perl libwww-robotrules-perl libxaw7 libxcb-renderO libxcb-shmO 
libxfontl libxft2 libxml-libxml-perl libxml-libxslt-perl 
libxml-namespacesupport-perl libxml -parser-perl libxml-sax-base-perl 
libxml-sax-expat-perl libxml-sax-perl libxml -twig-perl libxml-xpath-perl 
libxml2-dev libxmuG libxpG libxrenderl libxsltl.l libxtG lmodern luatex lynx 
lynx-cur netpbm nullmailer pdftk po-debconf poppler-data poppler-utils 
psutils tex-common texlive-base tex live-binaries texlive-common 
texlive-doc-base texlive-luatex unzip xll-common xfonts-encodings 
xfonts-utils xpdf 

) upgraded, 160 newly installed, to remove and 38 not upgraded. 

leed to get 115 ME of archives. 

Ifter this operation, 301 MB of additional disk space will 

)o you want to continue [Y/n]? I 



Command prompt screen asking for confirmation to continue with eprint installation 
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liblwp-protocol-https-perl libmagickcore4 libmagickcore4-extra 
libmagickwand4 1 ibmai 1-sendmai 1-perl libmail tools-perl libmime-lite-perl 
libmime-types-perl libmodule-f ind-perl libnet-http-perl libnetpbmlO 
libopenexrG libpangol,0-0 libpaper-utils libpaperl libpathplan4 libperl5,14 
libpixman-1-0 libpopplerl9 libreadlineS librsvg2-2 librubyl,8 
libsearch-xapian-perl libsepoll libsmG libsocketG-perl 

libsys-hostname-long-perl libthai-data libthaiO libtie-ixhash-perl 1 ibtif f4 
libtreS libunicode-string-perl libunistringO liburi-perl libwmf 0,2-7 
libwww-perl libwww-robotrules-perl libxaw7 libxcb-renderO libxcb-shmO 
libxfontl libxft2 libxml-libxml-perl libxml-libxslt-perl 

" xml -sax-base-perl 
rl libxml-xpath-perl 
libxml2-dev libxmuG libxpG libxrenderl libxsltl,l libxtG lmodern luatex lym 
lynx-cur netpbm nullmailer pdftk po-debconf poppler-data poppler-utils 
psutils tex-common texlive-base texlive-binaries tex live-common 
texlive-doc-base texlive-luatex unzip xll-common xfonts-encodings 
xfonts-utils xpdf 

1 upgraded, 160 newly installed, to remove and 39 not upgraded* 

■Jeed to get 115 ME of archives, 

1fter this operation, 301 MB of additional disk space will be used, 

Jo you want to continue [Y/n]? yes 

jJARNING; The following packages cannot be authenticated! 
sprints 

Install these packages without verification [y/N]? | 



Command prompt seeking confirmation to continue installing unverified packages. Yes should be 
keyed in and enter key pressed once to proceed further 



It 

It Getting Started: 


## 
## 


It Before you can start using eprints you need to 


## 


It configure your install, follow these simple steps; 


## 


It 


## 


It # su eprints 


## 


It You have to logged in as the eprints user to operate 


## 


It with eprints 


## 


It # cd 


## 


It To the eprints home directory (/usr/share/eprints3) 


## 


It 


## 


It # ,/bin/epadmin create 


## 


It Follow the instruction to create your archive. 


## 


It 


## 


It # exit 


## 


It 


## 


It # a2ensite eprintsS 
It 


## 
## 


it # apache2ctl restart 


## 

±t±t 


It ##### DONE ##### 


WW 

## 1 


It For more documentation please see the eprints wiki; 


WW 

WW 


It http ; //w i k i , eprints, or g/w/Documentat i on 


WW 



Eprint installation completed. 



Otolaryngology online 



After installation of eprint is completed now the installation should be configured. Eprint 
installation folder is present in /usr/share/eprints3. This should be remembered because it is 
important during configuration procedures. 



Setting up a new repository: 

This is the first step that should be taken during eprint configuration. For this to proceed a 
password need to be set up for eprint user. 



passwd eprints 



In the command prompt window key in the above command. 



System information as of Ue 



iiiwianiMiiiiBmii 



System load: 0*01 Processes; 78 

Usage of /: 22. « of 7.87GB Users logged in; 

Memory usage: 502 IP address for ethO: 10.203.78.11 

Swap usage; 02 

Graph this data and manage this system at htt| 

Get cloud support with Ubuntu Advantage Cloud Guest; 
http://www.ubuntu.comA 

Use Juju to deploy your cloud instances and workloads; 
https://juju.ubuntu.eom/#cloud-precise 

42 packages can be updated. 

i3 updates are security updates. 

.ast logintJiledJunJU? 11:3 
ibuntu@ip 
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In this screen shot you can see that you have the opportunity to create a password for eprint server. 
You need to key in the pass word and press enter twice. 



System information as of Wed 



15:18:15 UTC 2013 



System load; 0,01 Processes: 78 

Usage of /: 22, At of 7.87GB Users logged in: 

Memory usage: 502 IP address for ethO; 

Swap usage; 02 

Graph this data and manage this system at https;//landsc 

Get cloud support with Ubuntu Advantage Clout 
http ; //www , ubuntu , com/bus i ness/serv i ces/c 1 out 

Use Juju to deploy your cloud instances and workloads; 
https ; //j uj u , ubuntu , com/#c 1 ou 

42 packages can be updated* 

.9 updates are security updates. 



Last loginMjJedJun^ll;32;0! 
ubuntu@ipB*«**il*WBP:"$ sudo su 
r-oot@ip-^^^**^Bt/home/ubuntu# passwd eprints 
Enter new UNIX password: 
Rptuop npiii IINTSi password; I 



Screenshot showing the command prompt window asking for creation of password for eprint server 



Usage of /: 22,42 of 7,87GB Users logged in: 
Memory usage; 502 IP address for ethO; 

Swap usage; 02 

Graph this data and manage this system at https;//landscape, canonical, cor 

Get cloud support with Ubuntu Advantage Cloud Guest; 
http;//www, ubuntu, com/bus iness/serv ices/cloud 

Use Juju to deploy your cloud instances and workloads; 
https;// juju, ubuntu, com/#cloud-precise 

2 packages can be updated, 

.9 updates are security updates, 

.ast logi n;_wed Jun 12 11:32:05 2013 from , 
ibuntu@ip-^^^m|BL:~$ sudo su 
|;/home/ubuntu 
nter new UNIX password; 
tetype new UNIX password; 
>asswd; eassiiiQr^jDdated successfully 
l ootQip^P* B ***" B R^/home/ubuntu# sudo su eprints 
;pr i nts@ i p-^fr**«i*^BL ; /home/ubuntul | 
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Screen shot showing password for eprint server changed successfully 

Now is the time to log into eprint server as root user with all privileges. 

This you can do by keying in the following command in the command terminal. 



sudo su eprints 



You need to get into the folder in which eprints has been installed. 
The command for this step is as follows: 



cd /usr/ share/ eprintsS 



usage or / 



Memory usage; 5C 
Swap usage; 03 

Graph this data 



Processes; 
I of 7.87GB Users logged 

IP address for eth0;t 



is system at https^/lanr 1 - 



Get cloud support with Ubuntu Advantage Cloud Guest; 
http; //www, ubuntu.com/business/serv ices/cloud 



Use Juju to deploy your cloud instances and workloads; 
https;// juju, ubuntu, com/#cloud-precise 

\2 packages can be updated, 

.9 updates are security updates, 

_ast logi n^wed Jun 12 11:32:0! 
jbuntu@ip-^^^HHBL;'"'$ sudo su 
'ootQip-^mi Uj/home/ubuntu# passwd eprints 
inter newTTO^assword; 




dated successfully 
t/home/ubuntu 
L;/home/ubuntu$ | 



Screen shot showing sudo su eprints command being executed 



usciye ijt r i ££*' 
Memory usage; 50% 
Swap usage; 01 



user 5 luyyeu in; 

IP address for ethOs 



Graph this data and manage this system at https;//landscape, canonical, com/ 

Get cloud support with Ubuntu Advantage Cloud Guest; 
http ;//www, ubuntu, com/business/services/cloud 

Use Juju to deploy your cloud instances and workloads; 
https;// juju, ubuntu, com/#c loud-precise 

\2 packages can be updated, 

L9 updates are security updates. 



_ \™$ sudo su 

;/home/ubuntu# passwd eprints 



.ast login: li 
ibuntu@ip- 



'OOtUip 

inter new UNIKH 

ietype new UNIX password; 

>asswd; passwordupdated successfully 

■•ootli!ip J ^BB H,-l * ,> *!/home/uburitu# sudo su eprints 

ipr i ntsljj i p^Bi— aw MJUB ; /home/ubun tu$ cd /usr/share/eprints3 

iprints@ip^fc««(^**B;"$ ,/bin/epadmin create! 



Screen shot showing ./bin/epadmin create being used 
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i Juju to deploy your cloud instances and workloads; 
https;//juju,ubuntu,com/#c loud-precise 

jackages can be updated, 
.9 updates are security updates, 

.ast logi n: Med Jun 12 11:32:05 2013 from* 
ibuntu@ip-^H ^^fc;"'$ sudo su 
out M i p-J^^H ^pT/hLiine/ubunt i.i 
"nter new UNIX password; 
ietype new UNIX password; 
>asswd; ^gsuot^jDdated successfully 
*oot@ip-^^M****^/home/ubuntu# sudo su eprints 
prints@ip-w^*^**^E;/home/ubuntu$ cd /usr/share/eprints3 
prints@ip J 'B w8 " BW Wl:"$ ,/bin/epadmin create 

>eate an EPrint Repository 

'lease select an ID for the repository, which will be used to create a directory 
ind identify the repository* Lower case letters and numbers, may not start with 
i number, examples; "lemurprints" or "test3" 

Archive ID? otolaryngology! 



Screen shot showing command window asking for archive ID 

You will be prompted to provide archive ID. This ID will actually be used to create a directory in 
the eprint server and will also serve as an identification of the repository. Lower case letters and 
numbers can be used. The name should not start with a number. For testing purposes you can use 
the name "testl" for the archive. After choosing a name for archive ID a folder by that name will 
be created and relevant config files will be copied to it. 

The command prompt will ask for confirmation to configure vital settings. The answer should be 
yes followed by a press of enter key. 
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Installing: 
Installing: 
Installing; 
Installing: 
Installing: 
Installing; 
Installing: 
Installing: 
Installing; 
Installing: 
Installing: 
Installing: 
Installing: 
Installing: 



v usr/share/e 



v usr/share/eprint: 

y usr/share/eprint: 

v usr/share/e 

v usr/share/eprint: 

v usr/share/eprint: 

v usr/share/e 

v usr/share/eprint: 

v usr/share/eprint: 

v usr/share/eprint: 

v usr/share/eprint: 

v usr/share/epr i nt; 

v usr/share/eprint: 



3/archives/otolaryngology/cfg/static/style/auto 
3/ar ch i ves/oto 1 ar y ngo 1 ogy /cf g/autocomp 1 ete 



3/ar ch i ves/oto 1 ar y ngo 1 ogy /cf g/ 1 ang 
3/ar ch i ves/oto 1 ar y ngo 1 ogy /cf g/ 1 ang/en 



3/ar ch i ves/oto 1 ar y ngo 1 ogy /cf g/ 1 ang/en/stat i c/he 1 p 
3/archi ves/oto laryngology/cfg/lang/en/phrases 
3/archi ves/otolaryngology/cf g/workf lows 
3/ar ch i ves/oto 1 ary ngo 1 ogy /cf g/workf 1 ows/epr i nt 
3/arch i ves/oto 1 aryngo 1 ogy/cf g/workf 1 ows/user 
3/archi ves/oto laryngology/cfg/themes 



Ok, I've created the initial config files and directory structure, 
I've also created a "diskO" directory under documents/ if you want 
your full texts to be stored on a different partition then remove 
the diskO, and create a symbolic link to the directory you wish to 
store the full texts in, Additional links nay be placed here to be 
used when the first is full. 



Configure vital settings? [yes] ? | 



Screen shot showing the installer seeking premission to configure vital settings 



After giving yes and hitting the enter key further queries regarding other configuration settings will 
be posed by the eprint server to you. 

Host name: You need to give a host name in this window. It is actually the name when keyed in to 
your browser address bar will take you to the repository archive. You should already have a domain 
registered with a domain registrar and your domain should be pointing to the IP address of your 
virtual private server. 



Installing; /usr/share/eprints3/archi ves/otolaryngology/cf g/workf lows/eprint 
Installing: /usr/share/eprints3/archi ves/otolaryngology/cf g/workf lows/user 
[installing; /usr/share/eprints3/archi ves/otolaryngology/cf g/themes 

Ok, I've created the initial config files and directory structure, 
I've also created a "diskO" directory under documents/ if you want 
your full texts to be stored on a different partition then remove 
the diskO, and create a symbolic link to the directory you wish to 
store the full texts in, Additional links may be placed here to be 
used when the first is full. 



Configure vital settings? [yes] ? ye: 
Core configuration for otolaryngology 

Please enter the fully qualified hosl 

For a production system we recommend 
machine. 

Example; Otolaryngol ogy,footle,ac,uk 



the repository, 

jsing the real hostname of the 



JHostname? otolaryngology, co,in| 



For production system it is better not to use the real host name. You can always use "your archive 
name.localdomain." 

Now comes the query regarding web server port. 

Which port do you want to serve your archive on? The default port happens to be 80 and would be 
already entered there. If you want to stay with the default port just give enter and proceed to the 
next screen. 

Now comes the scree for alias: 

Here you can enter any number of aliases which will take users to the archive. You can serve your 
repository in various aliaes like eprints.mine.org, eprints.archive.org. After you have completed 
giving aliases you need to enter # and press enter key once. These aliases should be taken into 
consideration while configuring domain name that points towards the archive. This setting redirects 
requests from various aliases to the archive you have specified. 

When the configuration screen asks for confirmation to redirect all your choosen aliases to the host 
name give yes and press enter key once. 



In the next screen you will be asked to enter the path part of the repository's Base URL. This 
should be very simple. If you cant think of something just accept the default given [/] by pressing 
enter key once. 

In the next screen you will be given an opportunity to configure https host name. If you want to use 
secure server for log in pages you need to give the name in this screen. Otherwise you can skip this 
step by pressing the enter button once. 



Next comes the screen asking you to specify email of administrator. This will enable repository 
users to contact you. Please give the admin email account name in this screen. 

The installer will now ask for the archive name. This is the full name of the repository you are 
creating. It will also be displayed in the title bar of the browser displaying the archive. Just key in 
the desired name and press enter key once. 

The next question seen in the command prompt window would be a confirmation and permission to 
write those specified settings. If the answer is no then you say no and press enter key once, then 
one need to start repository configuration right from the start again. If yes it takes you to the next 
screen. 
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Next settings screen one need to focus is on the database configuration settings for the archive in 
question. In order for you to start this configuration you need to say yes to launch configdb 
archive _id. On launching configdb archiveid you will be presented with a screen where you can 
name the database. It is always better choose the default name which happens to be the name of the 
archive. It would have already been choosen by you by eprints server. All you need is to press the 
enter key once to accept default settings. Similarly you can choose the default settings for host, port 
and socket settings of the mysql database. All you need to do is to keep pressing the enter key for 
each of these settings to accept the default values. 

In the next screen user of database will be choosen. If you are not particular to have a unique name 
you are welcome to choose the default user name and eprints will keep track of it. The same goes 
for the choice of database user password. You can choose the default password alloted by eprints 
server by pressing the enter key once. You need not remember these details also. Eprints will keep 
track of them all for you. The configure screen will ask you for confirmation whether these settings 
could be written to the database. 

You can press enter button to accept all the database settings. In order to write to the database 
eprints need to know your root user name and password for the mysql server. This was already set 
by you while you installed mysql server in your virtual machine. Now is the time to enter the user 
name (which is root in this case) and root password when the prompt asks. You need to press enter 
key after keying in the root user name and press enter again after keying in the root password. 

After the database has been successfully created the eprint server will offer to create user for 
administering the repository. Now is the time to choose user name and press enter. While choosing 
the password you cannot start with a number or special character. Dont bother you can always 
change the password after installation. In the next prompt you will be asked the role which the 
created user is supposed to play (admin, user etc). In this case one need to choose admin as the 
role. Then you will be asked for email id of the user which you need to key in now and press enter 
key immediatly there after. 



You need to give yes when permission is sought by eprint server to create LOC subjects, create 
static pages etc. 

The next query will be whether you want to update apache config files. It would also remind you to 
verify whether the include line for eprint server has been added to apache config file. This can be 
verified by making sure that eprints3 file is in /etc/apache2/sitesavailable/ folder and eprints3 file 
contain the following line: Include /usr/share/eprints3/cfg/apache.conf 
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Create an EPrint Repository 

Please select an ID for the repository, which will be used to create a directory 

and identify the repository. Lower case letters and numbers, may not start with 

a number, examples: "entprints" or "tesf3" 

Archive ID? uclapr 

We need to create /var/lib/eprints3/archives/uclapr, doing it now... 

Getting uid and gid information for apache 

UID: 48 

GID: 48 

Configure vital settings? [yes] ? yes 

Hostname? eprints.adastral.ucl.ac.uk 

Webserver Port [80] ? 80 

Please enter all the aliases which could reach the repository, and indicate if 

you would like EPrints to write a Redirect Rule to redirect requests to this alias to the correct URL. 

Some suggestions: 

eprints.adastral 

eprints 

Enter a single hash (#) when you're done. 

Alias (enter # when done) [#] ? eprints.adastral 

Redirect entw-server to entw-server.grs.de [yes] ? 

Alias (enter # when done) [#] ? # 

Please enter the path part of the repository's base URL. This should probably be '/'. 

Path[/]? 

If you will use https for your user pages (including login) enter the https hostname 

here, or leave blank when using http only. 

Hostname? 

Administrator Email? *******@adastral.ucl.ac.uk 

Archive Name [Test Repository] ? UCL Adastral Park Repository 

Write these core settings? [yes] ? yes 

Configuring Database for: uclapr 

Database Name [uclapr] ? ********* 

MySQL Host [localhost] ? localhost 

MySQL Port (# for no setting) [#] ? 

MySQL Socket (# for no setting) [#] ? 

Database User [******] ? 

Database Password? 

Write these database settings? [yes] ? yes 

Create database "uclapr" [yes] ? 

Database Superuser Username [root] ? 

Database Superuser Password? 

Create database tables? [yes] ? 

Create an initial user? [yes] ? 

Enter a username [admin] ? 

Select a user type (user| editor) admin) [admin] ? 

Email? ******* @adastral.ucl. ac .uk 

Do you want to build the static web pages? [yes] ? 

Do you want to import the LOC subjects? [yes] ? no (I have a custom subject file) 

Do you want to update the apache config files? (you still need to add the 'Include' line) [yes] ? yes 
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You need to restart apache server now. 

There are two ways to restart the apache server now. 

Restarting apache server using command prompt window: 

For this to happen you need to get out of the eprint server which you have been configuring for so 
long. Just type exit in the command prompt and press enter key once. This will take you out of the 
eprint server and push you into the virtual machine. Now you key in the command given below to 
restart apache server. 



sudo service apache2 restart 



This will restart the server. 

The next method is to restart apache server via webmin. For this you need to log into webmin 
interface using your browser. You need to key in the user name and password to access the 
interface. 

In the webmin interface side bar click the servers button. It will open up showing a server list. 
Choose apache from the list to take you to the apache config screen. 



Now exit the terminal by typing exit followed by pressing the enter key. 

Relog into the server via webmin by typing https://your Ip: 10000. You can log in as root by using 
the root password. Make use of the file manager to verify whether eprints3 file is in 
/etc/apache2/sitesavailable/ folder and it contains the following line: 

Include /usr/share/eprints3/cfg/apache. conf 

If this line is not present you should add this now. Invariably it should be present. 
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Now is the time to enable the eprints site. For this you need to log into the server as root using 
Putty. They the following command should be keyed in: 



sudo alensite eprints3 



This enables the eprint site in your server. 

While creating eprint archive if you had accepted port 80 as the default port then you must disable 
the default site. This can be done by keying in the following command in the putty command 
prompt as root: 



sudo aldissite default 



Now you should restart apache server by keying in the following command as root: 



sudo /etc/init.d/apache2 restart 



This command is a must for apache to update the changes you have made so far. 



.ogin: root 



Webmin 
System 
server 

Apache Webserver 
BIND DNS Server 
MySQL Database Server 
Read User Mail 
S H Server 

Networking 

Hardware 

Cluster 
>> Un-used Modules 
Search: 



A View Module's Logs 
fit System Information 
f§! Refresh Modules 
@ Logout 



Screenshot of webmin interface showing the list of servers 
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Module Config 



Apache Webserver 

Apache version 2.2.22 



Global configuration Existing virtual hosts Create virtual host 
Select all. | invert selection. 




Apply Changes 
Stop Apache 
Search Docs.. 



/"~~~v Defines the default settin 
ij^ "#S Address Any 
'~ : -'' Port Any 
Default Server 


gs 


for all oth 


er virtual servers, and processes any 
Server Name Automatic 
Document Root Automatic 


unhandled 


requests. 


Handles the name-based 
»*^; Address 


if. 


rver e 










Server Name r 

Document Root /usr/share'ep 






D Virtual ServerPort 50 






1nts3 




Select all. | Invert selection. 












Delete Selected Servers j 





In the apache webserver screen you will see stop apache button which can be clicked and toggled 

with start apache 



If you key in your IP in the browser address window you should be able to see eprints log in screen. 




Welcome to Entrepo 

This is an Otolaryngology repository where otolaryngologists can store their manuscripts. 
Authors can deposit their manuscripts after registering themselves In this site. 



3 Atom EfflRSSLQ QJ RSS 2.0 



Latest Additions 

View items added to the repository in the past week. 



Search Repository 

Search the repository using a full range of fields. Use the search field at the top of the page for a quick search. 

Browse Repository 

Browse the items in the repository by subject. 



About this Repository 

More information about, this site. 



Repository Policies 

Policy for use of material in this repository. 



Erir £!..■::■ :..:.:.:<!■:■ -"— .: L . .Jtha base URL of h t tp://rhi mingy _in/cgi/nai2 



Entrepo is powered by EPrinfs 3 wtiich is deve toped by the School si Elsolronics nn .1 Con :...■■' " . ence at the Unwersityof Southampton '.[■.'■•- ■-: •■■ :■: -■ •-.• •.: ■:::: ::■.';•. :■-■■: :■:. . 



- -gofogy online 
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Screenshot showing eprints log in screen 



Regular maintenace of eprint installation is a must. The following tasks need to be performed 
frequently because EPrints front end web pages and abstracts *are not* automatically updated when 
you make changes to the repository. To apply your changes and update the web pages: 

1 . Generate views 

2. Generate statistics 

3. Generate abstracts. 

These maintenance tasks can easily be performed using command prompt window. 
Using SSH client PUTTY you should log into your virtual machine as root. 

1 . sudo su eprints 

2. In the next prompt enter eprint server user password 

3. You will be logged into eprints server 

Key in the following command to generate views: 
bin/generate jviews yourarchivename 
Key in the following command to generate statistics: 
bin/generate _static yourarchivename 

Key in the following command to generate abstracts: 

bin/generate _abstracts yourarchivename 

Remember you need to press enter button after giving each command for it to be executed. 
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The above said tasks can also be performed using eprint admin interface. 

First you need to log into eprint site as admin using the admin user name and password. This can 
be done via browser interface. Now on clicking the admin button you will be taken to admin 
interface where you can perform these tasks by clicking the appropriate buttons. 



Admin 



Editorial Tools 



Force Start Indexer 



Stop Indexer 



Regenerate Abstracts 



EPrints Bazaar 



Send Test Email 



System Tools Config. Tools 

Status information for this server. 
Create a new user account 

Forcefully stops and cleans up the indexer, then restarts it. 
Stops the full-text indexer. 

Cause abstract pages to be regenerated when they are next requested. 
Cause views pages to be regenerated when they are next requested. 
Manage, Update and Install add-ons from the EPrints Bazaar. 
Test your email configuration by sending a test email. 
Show the database schema. 



Eprint admin interface where one can perform maintenance tasks 
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Domain configuration 



If domain configuration is not done correctly the internal links of your e print installation may not 
work. While creating your archive you would have been prompted to provide domain name which 
you would have provided during the configuration stage. Now is the time to configure your domain 
name by making it point towards the eprint archive you have created. This can be performed using 
Bind server feature through webmin. 

Bind 13 14 is the most widely used DNS software for configuring DNS settings. The current version 
is Bind 9 which has managed to circumvent the security vulnerabilities of its earlier versions. 

Usually the commonly available Ubuntu VPS has Bind 9 installed by default. If that is not the case 
one need not worry unduly it can still be installed easily. 



Bind can be installed by keying in the following command as root in the putty terminal: 



sudo apt-get install bind9 



This command will install Bind 9 in your Ubuntu VPS if not installed already. 

After installation one needs to add bind module to webmin to make use of its friendly GUI for DNS 
configuration purposes. If installed already you see Bind server listed in webmin under the heading 
servers. 
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Webmin 




Backup Configuration Files 




Change Language and Theme 




Webmin Actions Log 




Webmin Configuration 




Webmin Servers Index 




Webmin Users 


► 


System 




Servers 




Apache Webserver ^0 




BIND DNS Server ^^^ 




Fete hm ail Mail Retrieval 




MySQL Database Server 




Proem ail Mail Filter 




Read User Mail 




Samba Windows File Sharing 




Sercdmail Mail Server 




SSH Server 


► 


Others 


► 


Networking 


► 


Hardware 


► 


Cluster 


Se 


Un-used Modules 


arch: \ 


View Module's Logs 


£ 


System Information 




Refresh Modules 


@ 


Logout 



Image showing Bind DNS server listed under the head servers in webmin 
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If you had installed Bind DNS server after installing webmin then you need to install webmin 
module to configure bind server. This can easily be installed as module by clicking webmin 
configuration under which module installation page can be found. 



Module Index 



Webmin Modules 



Install Clone Delete Export 
Webmin modules can be added after installation by using the form to the right. Modules are typically distributed in .wt™ files, each of which can contain one or 
more modules. Modules can also be installed from RPM files if supported by your operating system. 



Install Module 






Install from •< From local file 


u 


From uploaded file 


Choose File j Mo file chosen 


From ftp or http URL 








Standard modulefromwww.webmln.com 


QC 


Third party module from 


y 


Ignore dependencies? Yes * No 




Grant access to * Grant access only to users and groups : root 


Grant access to all Webmin users 



Install Module 



Webmin module installation screen is shown above. One needs to click in the box indicated by the 
arrow which will open up the module list. From this list Bind server module can easily be chosen 
and installed. After installation is completed the Bind server could be seen listed under the heading 
servers in the webmin menu. 

Using Bind server to configure domain: 



On logging into webmin as root after keying in the root password Binds can be found listed under 
server. On clicking Bind server link the configuration screen opens up. It is fairly easy to configure 
domain using bind server. Just by following the instructions given below carefully it becomes still 
more easy. 
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Login: root 



Webmin 

System 

Servers 

Apache Webserver 

BIND DNS Server 

Fetchmail Wail Retrieval 

MySQL Database Server 

Procmail Mail Filter 

Read User Mail 

Samba Windows File Sharing 

SandmaN Mall Server 

SSH Server 

Others 

Networking 

Hardware 

Cluster 
!> Un-used Modules 
Search: 



Module Config 



Global Server Options 



BIND DNS Server 

BIND version 9.S.1 



Apply Configuration 

Stop BIND 

Search Docs._ 



Other DNS Servers 








lL) 

Access Control Lists 


Files and Directories 


Forwarding and Transfers 


Addresses and Topology 




A 




Logging and Errors 


% 


m 


-~^ 


e 


m 


& 


Miscellaneous Options 


Control Interface Options 


DNS Keys 


Zone Defaults 


Cluster Slave Servers 


Setup RNDC 


DNSSEC Verification 


DN55EC Key Re-Signing 


Check BIND Config 


Edit Config File 







Existing DNS Zones 

Select all. | Invert selection. | Create master zone. | Create slave zone. | Create stub zone. | Create forward zone. | Create delegation zone. | Create zones from 
batch tile. 



Screen shot showing Bind configuration screen 



Under the menu existing zones click on "create master zone". 



Login: root 


Webmin 


System 


Servers 


Apache Webserver 


BIND DNS Server 


Fetchmail Mail Retrieval 


MySQL Database Server 


Procmail Mail Filter 


Read User Mail 


Samba Windows File Sharing 


Sendmail Mail Server 


SSH Server 


Others 


Networking 


. Hardware 


Cluster 


i> Un-used Modules 


Search: 


A View Module's Logs 


fit System Information 


[§3 Refresh Modules 


©Logout 



Module Config 



Global Server Options 



BIND DNS Server 

BIND version 9.9.1 



Apply Configuration 

Stop BIND 

Search Docs.. 



Other DNS Servers 








Access Control Lists 


w 

Files and Directories 


# 

Forwarding and Transfers 


- 

Addresses and Topology 




A 




Loggi 


g and 


Errors 


% 


m 


<o 


e 


m 


* 


Miscellaneous Options 


Control Interface Options 


DNS Keys 


Zone Defaults 


Cluster Slave Servers 


Setup RNDC 


- 

DNSSEC Verification 


y3 

DNSSEC Key Re-Signing 


Check BIND Config 


Edit Config File 







Existing DNS Zones 

Select all. | Invert selection^ Create master zone|| Create slave zone. | Create stub zone. | Create forward zone. | Create delegation zone. | Create zones from 
batch file. 




Screen shot showing create master zone menu link 
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Fill out the following details in the space as shown: 



Login; root 



Webmirt 

System 

Servers 

Apache Webserver 

BIND DNS Server 

Fete lim ail Mail Retrieval 

MySQL Database Server 

Procmail Mail Filter 

Read User Mail 

Samba Windows File Sharing 

SerKtmail Mail Server 

SSH Server 

Others 

Networking 

Hardware 

Cluster 
i> Un-used Modules 
Search: 



£i View Module's Logs 
jSfc System Information 
Refresh Modules 
Q Log ou i 



Module ndex 


Create Master Zone 


Apply Configuration 
Stop BIND 


New master zone options 


Zone type 
Domain name / Network 

Records tile 

Master server 

Email address 

Use zone template? 

Add reverses for template addresses? 
Refresh time 

Expiry time 


* Forward (Names to Addresses) Reverse (Addresses to Names) 




your domain.com 


♦' Automatic '-'| [J 


/' Add NS record for master server? 

1 Your domain.com 

.'Yes * Nb IP address for template records 

*' Yes ' No 


lp address 


10800 seconds t | Transfer retry time 


J3600 | seconds ▼ | 




604600 seconds * | Negative cache time 


[38400 | seconds ▼ | 


Create 







% Return to zone list 



Screen shot showing details to be filled in the create master zone screen 



1. "Domain name / Network": yourdomain.com 

2. "Master server" : Yourdomain.com 

3. "IP address for template records": [The external lp for your vps provided to you] 
- Click on create 
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This will take you to the "Edit Master zone" page. 



Rv^^ 


^ 


e 


S& 


Address (6) 


Name Server (3) 


Name Alias (0) 


Mail Server (1) 


<$ 


Am 


ty 


• 


Host Information (0) 


Text (0) 


Sender Permitted From (0) 


Well Known Service (D) 


GO 


<m 




© 




l ' 


Responsible Person (0) 


Reverse Address (0) 


Location (0) 


Service Address (0) 


«N 


a; 


& 




Public Key (0) 


IPv6 Address (0) 


All Record Types (10) 









•Vu 




c 


Edit Zone Options 
Setup DNSSEC Key 


Find Free IPs 




1 * f 


Edit Records File 


Edit Zone Parameters 
Lookup WHOIS Information 




% 




Reco 


d Gene 


rators 



Unfreeze Zone, 



Check Records 



Convert to Slave Zone 



Delete Zone: 



^ Return to zone list 



Click this button to freeze a dynamic zone before updating it. 

Click this button to unfreeze a dynamic zone after having updated it. 

Click this button to have BIND check the records in this zone, and report on any problems. 

Turns this master zone into a slave, so that it will receive records from another master server 

Click this button to delete this zone from your DNS server. Matching reverse address records 
server will also be deleted. 



instead of serving them locally, 
in other zones hosted by this 



Screen shot showing edit master zone for your domain screen 
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1. Click on "Address" 



Module index 



Address Records 

in yourdomain.com 



Apply Zone 

Apply Configuration 

Stop BIND 



Add Address Record 






Name 


TIme-To-Llve ♦ Default 1 -' |~ 
Mo 


| seconds ¥ | 


Address V ,_ , . 

IP address 

Update reverse? * Yes Yes (and replace existing)' - 



Create 






Screenshot showing editing address records for the domain 



Fill up the following details: 

1. "Name" : You should leave this blank 

2. "Address": You fill in the Ip of your virtual machine 

Click on create 

In the next scree fill in the following details: 
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Module index 



Address Records 

In yourbomain.com 



Apply zone 

Apply Configuration 

Stop BIND 



Add Address Record 


Name 


www 


Tlme-To-Llve • Default ® [" 
No 


| seconds » | 






Address 
Update reverse? 


121.111.121.132] | [J 

* Yes Yes (and replace existing) 



Select all. | Invert selection. 






Name 


TTL 


Address 


D yourdomain.com. 


Default 


121.111.121.132 



Select all. | Invert selection. 

Delete Selected * Delete reverses too? 



^ Return to zone list | Return to record types 



References: 



" Note the Ip keyed in the address column is a fictitious one" You need to key in your IP address 
there. 



"Name": www 
"Address": your ip address 
Click on create again. 

In the next ensuing screen fill in the details as shown below: 



Add Address Record 


Name 


mall Tlme-To-Llve ♦ Default'.' 


| seconds t | 






Address 


121.111.121.132J [[J 


Update reverse? 


* Yes Yes (and replace existing) No 








Create 





Select all. | Invert selection. 

Name TTL 

D yourdomain.com. Default 

Select all. | Invert selection. 

Delete Selected] @ Delete reverses too? 

Return to lore list I Return to record types 



Address 

121.111.121.132 



Name 

D www.yourdomain.com. 



TTL Address 

Default 121.111.121.132 
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"Name": mail 

"Address": your ip address goes here 

Now click on create. 



Moauie index 



Address Records 

In yourdomain.com 



Apply zone 

Apply Configuration 

Stop BIND 



Add Address Record 


Name |ftP 


Tlme-To-Llve * Default 
No 


| seconds T | 


Address |i21.111.121.132| \\^ 
Update reverse? • Yes Yes (and replace existing) 



Create 



Select all. | Invert selection. 

Name 

□ yojrdomain.com. 
www.yourdomain.corr 

Select all. | Invert selection. 

i Delete Selected! 8 Delete reverses too? 

^ Return to zone list | Return to record types 



Name 


TTL 


Address 


Name 


TTL 


Address 


□ yojrdomain.com. 


Default 


121.111.121.132 


D mail.yourdomain.com. 


Default 


121.111.121.132 


_! www.yourdomalri.com. 


Default 


121.111.121.132 





Screen shot showing the next screen 



In the next screen key in the following details: 
"Name": ftp 

"Address": Your IP address goes here 
Now click create 

In this screen you can assign name server details: 
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Module index 



Address Records 

In yourdomain.com 



Apply zone 

Apply Configuration 

Stop BIND 



Add Address Record 


Name 


I«1 


Tlme-To-Llve • Default I 
No 


| seconds * | 


Address 


121.111.121.132| IU 


Update reverse? 


* Yes Yes (and replace existing) 



Create 



Select all. | Invert selection 
Name 
D yojrdomain.com. 
U www.yourdomain.com 

Select all. | Invert selection. 

j Delete Selected! <<£< Delete reverses too? 



Name 


TTL 


Address 


Name 


TTL 


Address 


D yojrdomain.com. 


Default 


121.111.121.132 


D mail.yourctomain.com. 


Default 


121.111.121.132 


... www.yourckjmain.com. 


Default 


121.111.121.132 


FTP.yourdomain.com. 


Default 


121.111.121.132 



^ Return to zone list | Return to record types 



Screenshot showing the screen where name server details can be entered 



'Name" : nsl 



"Address": key in your ip address here 



Click on create 



Next screen is shown below: 



Module Index 



Address Records 

lnyourdomain.com 



Apply Zone 

Apply Configuration 

Stop BIND 



Add Address Record 


Name 


ns2 


Tlme-To-Llve ♦ Default -F 
No 


| seconds » | 


Address 


121.111.121.132J |U 


Update reverse? 


* Yes Yes (and replace existing) 



Create 



Select all. | Invert selection. 



Name 


TTL 


Address 




Name 


TTL 


Address 


D yourdomain.com. 


Default 


121.111.121.132 


D 


FTP.yourdomain.com. 


Default 


121.111.121.132 


I I www.yourdomain.com. 


Default 


121.111.121.132 


D 


ns1 .yojrdomain.com. 


Default 


121.111.121.132 


U mail.yourdomain.com. 


Default 


121.111.121.132 











Select all. | Invert selection. 

Delete Selected! ,: ' Delete reverses too? 

Return to zone list | Return to record types 
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In the next screen fill in the following details: 

"Name": ns2 

"Address": your ip address 

Now click on create. 



Using this template you can add any number of name servers to your domain. This name servers 
are used when someone types in "name.yourdomain.com" in their browser. 



After completing the above steps you need to click "Retrun to record types" at the bottom of the 
page. 



Module Index 



Address Records 

In yourdomain.com 



Apply Zone 

Apply Configuration 

Stop BIND 



Add Address Record 


Name 




TIme-To-Llve ♦ Default 1 T~ 
No 


| seconds » | 






Address P 


y 


Update reverse? * Yes 


Yes (and replace existing) 



Create 



Select all. | Invert selection 

Name 

D yourtSomain.com. 
D www.yourdomain.com 
D mail.yourttomain.com 

Select all. | Invert selection. 

Delete Selected <£ Delete reverses too? 





Name 


TTL 


Address 




Name 


TTL 


Address 


D 


yourdomain.com. 


Default 


121.111.121.132 


D 


FTP .youroom ain.com. 


Default 


121.111.121.132 


D 


www.yourdomaln.com. 


Default 


121.111.121.132 


D 


ns 1 .yourdom ai n. com . 


Default 


121.111.121.132 


D 


mail.yourttomain.com. 


Default 


121.111.121.132 


D 


ns2.yourdomain.com. 


Default 


121.111.121.132 



Return to zone list !| Return to lecorc types * 



Screenshot showing where one should click to get to the record types screen 
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Now is the time to create name server records 



Module Index 



Edit Master Zone 



yourdomain.com 



Freeze Zone; 



Unfreeze Zone 



Apply Zone 

Apply Configuration 

Stop BIND 



B 


^0 


% 


^ 


Address (6) 


Name Server (1) 


Name Alias (0) 


Mail Server (0) 


<$ 


Aa 


? 


• 


Host Information (0) 


Text (0) 


Sender Permitted From (0) 


Well Known Service (0) 


(Xj 






e 




i 


Responsible Person (0) 


Reverse Address (0) 


Location (0) 


Service Address (0) 


<ssQ 


A; 


qp 




Public Key (0) 


IPv6 Address (0) 


All Record Types (7) 







&\\ 




c 


e 

Edit Zone Options 
Setup DNSSEC Key 


Find Free IPs 




l_ - I 


Edit Records File 


Edit Zone Parameters 
Lookup WHOIS Information 




*\ 




Reco 


d Gene 


rators 



Check Records 



Convert to Slave Zone; 



^ Return to zone list 



Click this button to freeze a dynamic zone before updating it. 

Click this button to unfreeze a dynamic zone after having updated it. 

Click this button to have BIND check the records in this zone, and report on any problems. 

Turns this master zone into a slave, so that it will receive records from another master server instead of serving them locally. 

Click this button to delete this zone from your DNS server. Matching reverse address records in other zones hosted by this 
server will also be deleted. 



Screenshot showing edit master zone screen 
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1 . Now click on the "name server" icon 



Fill out the following details as shown: 



Module Index 



Name Server Records 

In yourdomain.com 



Add Name Server Record 


Zone Name 
Name Server 


yourdomain.com. 


Tlme-To-Llve ♦ Default' .' f 


| seconds T j 


ns1.yourdomain.com. 


(Absolute names must end with a .) 









Select all. | Invert selection. 
Delete Selected 



^fc Return to zone list | Return to record types 



Apply Zone 

Apply Configuration 

Stop BIND 



Create 






Select all. | Invert selection. 




Name 


TTL 


Name Server 


U yourdomain.com. 


Default 


otolaryngology, co.in. 



Screen shot showing details of name servers in name server records 



"Zone name" : yourdomain.com. (Note you must add a dot next to the word com as shown in the 
screen shot. It is called trailing period.) 

"Name server": nsl.yourdomain.com. (Note you must add a dot next to the word com as shown in 
the screen shot. It is called trailing period.) 



Now click on create. 

In the next screen add details of second name server: 

"Zone name: yourdomain.com. (trailing period should be added) 

"Name server": ns2yourdomain.com. (trailing period should be added) 

Click create. 

After completion of above steps click on "Return to record types" present at the bottom of the page. 



Otolaryngology online 



Creating Mail Exchange record MX record: 



Address (8) 

<$> 

Host Information (0) 

Responsible Person (0) 

"~-^_ ,: ' 
Public Key (0) 



Edit Records File 



jsg 



Re-cord Generators 



yourdomarn.com 






\isi 


B 


Name Server (2) 


Name Alias (0) 


An 


^ 


Text (0) 


Sender Permitted From (D) 


<m 




& 




Reverse Address (0) 


Location (0) 


A> 


<& 


IPv6 Address (0) 


All Record Types (5) 


1 ■ ' f 


® 


Edit Zone Parameters 


Edit Zone Options 


© 


«* 


Lookup WHOIS Information 


Setup 


DNSSEC Key 



il Server ( 



Mail Server (0) 



Well Known Service (0) 



Service Address (0) 



Find Free IPs 



Screenshot showing record types where you can configure mail server details 



Click on the mail server icon as shown above. 
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Module Index 



Mail Server Records 

In yourdomain.com 



Apply Zone 

Apply Configuration 

Stop BIND 



Add Mall Server Record 


Name 
Mall Server 


yourdomain.com. 


Tlme-To-Llve • Default 


| seconds T | 


mail.yourdomain.com 


Priority 


10 



Create 



>. Re-turn to zone list | Return to record types 



Screenshot showing mailserver records being configured 



Fill out the following details as shown below: 

"Name" :yourdomain. com 

"mailserver":mail.yourdomain.com 

"priority": 10 

Now click on create 

After completing these steps click on return to record types found at the bottom of the page. 



Now click on the Binds server found under servers list. 



Global Server Options 



t2\ 



Otter DNS Servers Logging and Errors Access Control Lists 

Miscellaneous Options Control Interface Options DNS Keys 



Files and Directories Forwarding and Transfers Addresses and Topology 



Zone Defaults Cluster Slave Servers Setup RNDC 



-- J- <^3 



DNSSEC Verification DNSSEC Key Re-Signing Check BIND Config Edit Config File 
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Allow access to your DNS server: 



In the ensuing screen under global server options click on Zone Defaults icon. 





Default zone settings 


Allow 
transfers 


* Default 


Listed 




Allow 
queries 


Default * Listed .. 








any 


from.. 
Check 






/, 


from.. 
Check 












names In 
master 


Ignore 


' Warn - 


Fail * Default 


names In 
slave 


Ignore ' - ' Wam ' ' Fail * Default 


zones? 








zones? 




Check 








Notify 




names In 


ignore 


Warn 


Fail * Default 


slaves of 


' Yes ■.No'*' Default 


responses? 








changes? 





a 



Save 



■■- Return to zone list 



Under the default zone settings ensure that "Allow queries from" box shows any instead of local 
host. The listed radio button should be checked as shown in the screen shot above. This will allow 
anyone to query your DNS server. 

Click on the save button to commit your changes. 

Click on the return to zone list found at the bottom of the page. 



A 



Other DNS Servers Logging and Errors Access Control Lists Files and Directories Forwarding and Transfers Addresses and Topology 



Miscellaneous Options Control Interface Options DNS Keys 



DNSSEC Verification DNSSEC Key Re-Signing Check BIND Config 



Zone Defaults Cluster Slave Servers Setup RNDC 



Edit Config File 
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Click on address and Topology icon: 



Muuuie irtuex 

Global address, and topology options 
Ports and Default ♦ Listed below.. 
addresses Port number 

to listen on 



■ Default * 
'* Default 



53 



Source IP 
address for * Default 
queries 

Source IP 
address for * Default 
transfers 



Addresses and I opology 



rtppiy ouiinyuiauuii 
Stop BIND 



Closest IP IP address 



Nameserver * ag^M Listed . 
choice 
topology 



Addresses 



any 



Source 

port for * Default Port number] 

queries 

Source 

port for * Default Port number 
transfers 

Allow * Default Usted .. 
recursive 
queries 
from 



Return to zone list 



Under "Global address and topology options" under "ports and address to listen on" select listed 
below radio button and enter "53" in the text box as shown in the screen shot above. This indicates 
that the Dns server is running on port 53. In the "Addresses" column enter "any" to allow anyone 
to access this port. 

Click on save button to commit the setting you have given. 

Now is the time to restart the Bind server by clicking stop binds and start bink links athe top left 
corner of the page. 



Now is the worst part. You may need anywhere between a few hours to a day for these data to 
probagate and your site to become accessible when someone keys your domain name in the address 
bar of their browser. 



Otolaryngology online 



References: 

1. http://en.wikipedia.org/wiki/EPrints 

2. http://en.wikipedia.org/wiki/Repository 

3. http://www.openarchives.org/news/upsl-press.htm 

4. http://en.wikipedia.org/wiki/LAMP_(software_bundle) 

5. http://en.wikipedia.org/wiki/Virtual_private_server 

6. http://en.wikipedia.org/wiki/Webmin 

7. http://en.wikipedia.org/wiki/Secure_Shell 

8. "What is MySQL?". MySQL 5.1 Reference Manual. Oracle. Retrieved 17 September 2012. "The 
official way to pronounce "MySQL" is "My Ess Que Ell" (not "my sequel")" 

9. https://en.wikipedia.org/wiki/Rasmus_Lerdorf 

10. http://www.webmin.com/intro.html 

11. http://en.wikipedia.org/wiki/PhpMyAdmin 

12. http://wiki.eprints.Org/w/Getting_Started_with_EPrints_3 

13. http://en.wikipedia.org/wiki/BIND 

14. http://www.eecs.berkelev.edu/Pubs/TechRpts/1984/CSD-84-182.pdf 



Otolaryngology online 



Explanation of terms used in this book: 

1 . Repository - Indicates a location for safe storage and preservation 

2. OAI - Open archives initiative - Document standard that facilitates efficient dissemination of 
digital content 

3. LAMP - This is actually a software bundle comprising Linux (operating system), Apache (Web 
server) MySQL (Database software) PHP, PERL, and Python (the languages used in developing this 
software) 

4. GUI - Graphic user interface. 

5. SHH - Secure shell is a cryptographic network protocol used for secure data communication via 
command line. 



6. Apache - this is an opensource server software. Rough estimates reveal that nearly 50% of 
world's servers run apache. This is a http server. 

7. SQL - Means structured query language 



8. Database - This application stores a collection of data. The common application used for this 
purpose is MySQL server. 
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